Upgrading the WEM Software


Upgrading the WEM Software
 
 
The information and instructions in this chapter should be used to upgrade a WEM installation. These instructions assume that you have already obtained the upgrade file(s) and have stored them on the server running the WEM application.
Two upgrade types are currently supported:
Automated: Once executed, the WEM installation file detects previously installed versions of the application. If an older version is present, you are prompted as to whether or not you would like to perform an upgrade.
Because this process preserves all application database information from the currently installed version, it is only supported for n-2 releases, where n is the new version being installed. For example, the automated process can be used to upgrade either the 4.5.x or 5.0.x releases to version 5.1.x.
Manual: This type involves uninstalling any existing instances of the application and installing the new version.
This type must be used if the current instance is more than two releases older than the new version being installed. For example, the manual upgrade type must be used if 3.5.x is currently installed and you would like to upgrade to 5.1.x.
Caution: Please contact your local support representative to ensure compatibility prior to upgrading.
Important: The WEM application does not provide an automated mechanism for performing software “downgrades” (reverting to an older software version from a newer one). However, the instructions provided in the Performing a Manual Upgrade section of this chapter can be used since that procedure requires you to uninstall the existing version and install the alternate. Information is also provided for migrating database information.
This chapter includes the following topics:
 
Important: Unless otherwise specified, all information in this chapter applies to both Sun Solaris- and Red Hat Enterprise Linux-based WEM systems.
 
Pre-Upgrade Procedures
Important: Make sure that you check the status of your system with your system administrator. The information in the “Pre-Upgrade Checklist” will need to be verified and recorded before proceeding to the section Performing an Automated Upgrade or Performing a Manual Upgrade .
 
XML Report Generation
You can enable/disable XML report generation of the bulk statistics by using “Generate XML Files”. Alternatively, it can be enabled/disabled by configuring the XMLDataEnable parameter to 1 in the bsserver.cfg file (in the /<ems_dir>/server/etc directory by default). If enabled, the files are stored on the EMS server (the /<ems_dir>/server/xmldata directory by default).
 
Unpacking the Installation Files
WEM installation files are distributed as a single compressed file with a “.tar.gz” extension.
Once the installation file has been copied to the server, use the following procedure to unpack the file:
Step 1
Step 2
gunzip file_name.tar.gz
file_name is the name of the WEM application installation file.
Step 3
tar -xvf file_name .tar
Decompressing the installation file results in the following files:
setup.bin: The installation binary file.
inst: The executable file used to initiate the installation. This file is used for both the console- and the GUI-based methods.
uninst: Once the WEM application has been installed, this file must be copied to the /<ems_dir>/_uninst/ directory. It is the executable file for uninstalling the application for both the console- and GUI-based methods.
file_name.tar: A compressed file containing all of the application files required for both the script- and GUI-based installation methods.
README: A text file containing information pertaining to the release.
Step 4
 
Performing an Automated Upgrade
This section provides information and instructions for performing an automated upgrade as described previously in this chapter.
 
Determining the Best Upgrade Method
The WEM, and its ancillary components such as the Apache web server and PostgreSQL database engine, may be installed using one of following methods.
 
GUI-based method: This method is the most often used installation procedure. Requirements for using this method include:
Console-based method: This method is available to users who do not have an X-Windows client available for remote network connectivity to the WEM server via Telnet or SSH.
It is important to note that the upgrade method is independent of the method used for installation. For example, if the console-based method was used for installation, either the GUI- or console-based method can be used to perform the upgrade.
Depending on the desired installation method, proceed to either the Upgrading the WEM Software using the Console-Based Installation Method or Upgrading the WEM Software using the GUI-Based Installation Wizard section of this chapter.
 
Upgrading the WEM Software using the GUI-Based Installation Wizard
Follow the instructions below to upgrade the WEM using the GUI-based wizard.
Step 1
Step 2
./inst
The WEM Installer dialog box appears.
Step 3
Click the Next button. The system automatically checks for an installed version of the application. If a version is installed, a warning dialog appears.
Step 4
Click Yes to proceed.
Step 5
Follow the on-screen prompts to progress through the various installation dialogs and configure the parameters as required. Refer to the WEM Installation Parameter Descriptions table for descriptions of the configurable parameters on each of the installation dialogs.
Once you have completed the upgrade and all processes have started, a confirmation dialog box appears reporting that the installation was successful.
Step 6
Click the Finish button to exit the GUI-based installation wizard.
Step 7
Starting EMS Server...
EMS Server started.
PID: 1370
Logfile generated as:
./log/SERVER_LOG_20051220_142931/SERVER_LOG
Please check file /<ems_dir>/server/log/.server.log for additional debug messages
Starting Script Server...
Script Server started.
PID: 1389
Logfile generated as:
./log/SCRIPT_LOG_20051220_142937/SCRIPT_LOG
The following table lists the processes that are started at installation:
Important: The NorthBound Server and Notification Service processes are customer-specific and are not operational without the appropriate license. Please contact your local sales representative for additional information.
All log files are stored in the /<ems_dir>/server/log directory by default. Refer to the log files for additional information in the event that one or more of the processes did not start properly.
Step 8
Copy the uninstallation script to the _uninst directory created during the installation process (/<ems_dir>/_uninst by default) by entering the following command:
cp uninst /<ems_dir>/_uninst/
Step 9
cp ems_migrate /<ems_dir>/server/scripts
cp README.ems_migrate /<ems_dir>/server/scripts
 
Upgrading the WEM Software using the Console-Based Installation Method
Follow the instructions below to upgrade the WEM using the console-based installation script.
Step 1
Step 2
./inst -console
A message appears welcoming you to the WEM installation.
Step 3
Enter “1” to proceed to the EMS Upgrade Check configuration prompts. The system automatically checks for installed version of the application. If a version is installed, a message appears asking if you would like to upgrade the current installation.
Step 4
Step 5
Follow the on-screen prompts to proceed through the upgrade and configure the various parameters as required. Refer to the WEM Installation Parameter Descriptions table for descriptions of the configurable parameters within each of the sections of the script.
Once you have completed the upgrade and all processes have started, you receive a message indicating that the WEM was successfully installed.
Step 6
Step 7
Starting EMS Server...
EMS Server started.
PID: 1370
Logfile generated as:
./log/SERVER_LOG_20051220_142931/SERVER_LOG
Please check file /<ems_dir>/server/log/.server.log for additional debug messages
Starting Script Server...
Script Server started.
PID: 1389
Logfile generated as:
./log/SCRIPT_LOG_20051220_142937/SCRIPT_LOG
The following table lists the processes that are started at installation:
Important: The NorthBound Server and Notification Service processes are customer-specific and are not operational without the appropriate license. Please contact your local sales representative for additional information.
All log files are stored in the /<ems_dir>/server/log directory by default. Refer to log files for additional information in the event that one or more of the processes did not start properly.
Step 8
Copy the un-installation script to the _uninst directory created during the installation process (/<ems_dir>/_uninst by default) by entering the following command:
cp uninst /<ems_dir>/_uninst/
Step 9
cp ems_migrate /<ems_dir>/server/scripts
cp README.ems_migrate /<ems_dir>/server/scripts
 
Performing a Manual Upgrade
Follow the instructions in this section to perform a manual upgrade as described previously in this chapter. These instructions assume that a version of the application is currently installed and that it was installed in the default directory, /users/ems.
Important: The instructions in this section can also be used to perform a software downgrade of the WEM if required.
Step 1
Step 2
Optional. If you wish to preserve database information for the currently installed version, follow the instructions in the Performing a Database Back-Up using the backup Script section of this chapter and then proceed to Step 3 of this procedure.
Step 3
Uninstall the WEM using the instructions provided in the Uninstalling The WEM chapter of this guide and proceed to Step 4 of this procedure.
Step 4
Install the desired version of the WEM using the instructions provided in the Installing the WEM Software chapter of this guide and proceed to Step 5 of this procedure.
Step 5
Optional. If database information was backed-up per Step 2 of this procedure, restore the data using the instructions in the Performing a Database Restoration using the backup Script section of this chapter and proceed to Step 6 of this procedure.
Step 6
Start WEM Server processes using the instructions in the Step 3: Start WEM Server Application section of WEM Server Files and Operation chapter of this guide.
 
 
Reconfiguration of Bulkstat Schemas
Once the WEM software upgrade is completed successfully, you are required to configure the schemas. This process involves two steps:
 
 
Deleting an Already Configured Schema
For deleting the already configured schemas, follow the instructions below:
Step 1
Step 2
In the main menu, go to Accounting > Bulk Statistics Configuration. The Bulk Statistics dialog box opens.
Step 3
Click the Configure button to launch the Bulk Statistics Configuration dialog box.
Step 4
Step 5
After selecting all the configured schemas, click the Delete icon. Warning message displays.
Step 6
Click Yes to delete the selected schemas and click the Apply button. Another warning message displays.
Step 7
Click No to ignore the warning. The successful configuration message displays.
Step 8
Click OK to finish.
 
Reconfiguring Schemas
For reconfiguration of schemas, follow the instructions below:
Step 1
Step 2
In the main menu, go to Accounting > Bulk Statistics Configuration. The Bulk Statistics dialog box opens.
Step 3
Click the Configure button to launch the Bulk Statistics Configuration dialog box.
Step 4
Select the schemas to be configured under the Schema tab and click the Add icon.
Step 5
Click the Apply button to configure the selected schemas. You may get a warning message “You have selected some obsolete and/or WEM unsupported counters. Unsupported counters will not be parsed by WEM. Do you want to continue?”
Step 6
Click Yes to close the warning. The successful configuration message displays.
Step 7
Click OK to finish configuring schemas.
 
Preserving Database Information
Database preservation is done using the backup.sh script located in the /<ems_dir>/server/scripts directory by default. This script is used to perform both database back-ups and restorations.
Information and instructions for using this script are provided in this section.
 
Performing a Database Back-Up using the Backup Script
Follow the instructions in this section to back-up database information prior to upgrading or downgrading WEM software.
Important: The instructions provided in this section are intended for use with those located in the Performing a Manual Upgrade section of this chapter.
Step 1
cd /<ems_dir>/server/scripts
Step 2
./backup.sh
This script automatically stops all WEM processes and takes the backup of the WEM database using pg_dumpall command. You are notified once the back-up is complete.
Step 3
Return to Step 3 of the procedure in the Performing a Manual Upgrade section of this chapter.
 
Restoring a Database Using the Backup Script
Follow the instructions in this section to restore database information after performing a WEM software upgrade or downgrade.
Important: The instructions provided in this section are intended for use with those located in the Performing a Manual Upgrade section of this chapter.
Step 1
cd /<ems_dir>/server/scripts
Step 2
./backup.sh restore
This script automatically stops all WEM processes and performs the database restoration. You are notified once the database restoration is complete.
Step 3
Return to Step 6 of the procedure in the Performing a Manual Upgrade section of this chapter.
 
 

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883